HL7 FHIR Implementation Guide: ZM-Core Release 1 - Zambia
​0.1.0 - Zambia flag

HL7 FHIR Implementation Guide: ZM-Core Release 1 - Zambia - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Resource Profile: ZM-Core Practitioner Role Profile

Official URL: http://hapi.moh.gov.zm/fhir/StructureDefinition/zm-core-practitioner-role Version: 0.1.0
Active as of 2026-08-12 Computable Name: ZMCorePractitionerRole

A current health-worker role used to route communications by responsibility rather than by hard-coded contact details.

Usages:

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots, and their representations.

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PractitionerRole 0..* PractitionerRole Roles/organizations the practitioner is associated with
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... contained 0..* Resource Contained, inline Resources
... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored
... active SΣ 1..1 boolean Whether this practitioner role record is in active use
... period SΣ 0..1 Period The period during which the practitioner is authorized to perform in these role(s)
... practitioner SΣ 1..1 Reference(ZM-Core Practitioner Profile) Practitioner that provides services for the organization
... organization SΣ 1..1 Reference(ZM-Core Organization Profile) Organization where the roles are available
... code SΣ 1..* CodeableConcept Roles which this practitioner may perform
Binding: PractitionerRole (example): The role a person plays representing an organization.
... specialty SΣ 0..* CodeableConcept Specific specialty of the practitioner
Binding: PracticeSettingCodeValueSet (preferred): Specific specialty associated with the agency.
... location SΣ 1..* Reference(ZM-Core Location Profile) Location(s) where the practitioner provides care
... healthcareService S 0..* Reference(ZM-Core Healthcare Service Profile) Healthcare services provided for this role's Organization/Location(s)
... contact S 1..* ExtendedContactDetail Official contact details relating to this PractitionerRole
... communication S 0..* CodeableConcept A language the practitioner (in this role) can use in patient communication
Binding: AllLanguages (required): IETF language tag for a human language
Additional BindingsPurpose
CommonLanguages Starter

... availability S 0..* Availability Times the Practitioner is available at this location and/or healthcare service (including exceptions)
... endpoint S 0..* Reference(Endpoint) Endpoints for interacting with the practitioner in this role

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
PractitionerRole.code Base example Practitioner Role 📍5.0.0 FHIR Std.
PractitionerRole.specialty Base preferred Practice Setting Code Value Set 📍5.0.0 FHIR Std.
PractitionerRole.communication Base required All Languages 📍5.0.0 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error PractitionerRole If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error PractitionerRole If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().ofType(canonical) | %resource.descendants().ofType(uri) | %resource.descendants().ofType(url))) or descendants().where(reference = '#').exists() or descendants().where(ofType(canonical) = '#').exists() or descendants().where(ofType(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error PractitionerRole If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error PractitionerRole If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice PractitionerRole A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PractitionerRole 0..* PractitionerRole Roles/organizations the practitioner is associated with
... identifier S 1..* Identifier Identifiers for a role/location
... active S 1..1 boolean Whether this practitioner role record is in active use
... period S 0..1 Period The period during which the practitioner is authorized to perform in these role(s)
... organization S 1..1 Reference(ZM-Core Organization Profile) Organization where the roles are available
... code S 1..* CodeableConcept Roles which this practitioner may perform
... specialty S 0..* CodeableConcept Specific specialty of the practitioner
... location S 1..* Reference(ZM-Core Location Profile) Location(s) where the practitioner provides care
... healthcareService S 0..* Reference(ZM-Core Healthcare Service Profile) Healthcare services provided for this role's Organization/Location(s)
... contact S 1..* ExtendedContactDetail Official contact details relating to this PractitionerRole
... communication S 0..* CodeableConcept A language the practitioner (in this role) can use in patient communication
... availability S 0..* Availability Times the Practitioner is available at this location and/or healthcare service (including exceptions)
... endpoint S 0..* Reference(Endpoint) Endpoints for interacting with the practitioner in this role

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PractitionerRole 0..* PractitionerRole Roles/organizations the practitioner is associated with
... id Σ 0..1 id Logical id of this artifact
... meta Σ 0..1 Meta Metadata about the resource
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... extension 0..* Extension Additional content defined by implementations
... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored
... identifier SΣ 1..* Identifier Identifiers for a role/location
... active SΣ 1..1 boolean Whether this practitioner role record is in active use
... period SΣ 0..1 Period The period during which the practitioner is authorized to perform in these role(s)
... practitioner SΣ 1..1 Reference(ZM-Core Practitioner Profile) Practitioner that provides services for the organization
... organization SΣ 1..1 Reference(ZM-Core Organization Profile) Organization where the roles are available
... code SΣ 1..* CodeableConcept Roles which this practitioner may perform
Binding: PractitionerRole (example): The role a person plays representing an organization.
... specialty SΣ 0..* CodeableConcept Specific specialty of the practitioner
Binding: PracticeSettingCodeValueSet (preferred): Specific specialty associated with the agency.
... location SΣ 1..* Reference(ZM-Core Location Profile) Location(s) where the practitioner provides care
... healthcareService S 0..* Reference(ZM-Core Healthcare Service Profile) Healthcare services provided for this role's Organization/Location(s)
... contact S 1..* ExtendedContactDetail Official contact details relating to this PractitionerRole
... characteristic 0..* CodeableConcept Collection of characteristics (attributes)
Binding: ServiceMode (example): A custom attribute that could be provided at a service (e.g. Wheelchair accessibility).
... communication S 0..* CodeableConcept A language the practitioner (in this role) can use in patient communication
Binding: AllLanguages (required): IETF language tag for a human language
Additional BindingsPurpose
CommonLanguages Starter

... availability S 0..* Availability Times the Practitioner is available at this location and/or healthcare service (including exceptions)
... endpoint S 0..* Reference(Endpoint) Endpoints for interacting with the practitioner in this role

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
PractitionerRole.language Base required All Languages 📍5.0.0 FHIR Std.
PractitionerRole.code Base example Practitioner Role 📍5.0.0 FHIR Std.
PractitionerRole.specialty Base preferred Practice Setting Code Value Set 📍5.0.0 FHIR Std.
PractitionerRole.characteristic Base example Service Mode 📍5.0.0 FHIR Std.
PractitionerRole.communication Base required All Languages 📍5.0.0 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error PractitionerRole If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error PractitionerRole If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().ofType(canonical) | %resource.descendants().ofType(uri) | %resource.descendants().ofType(url))) or descendants().where(reference = '#').exists() or descendants().where(ofType(canonical) = '#').exists() or descendants().where(ofType(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error PractitionerRole If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error PractitionerRole If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice PractitionerRole A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PractitionerRole 0..* PractitionerRole Roles/organizations the practitioner is associated with
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... contained 0..* Resource Contained, inline Resources
... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored
... active SΣ 1..1 boolean Whether this practitioner role record is in active use
... period SΣ 0..1 Period The period during which the practitioner is authorized to perform in these role(s)
... practitioner SΣ 1..1 Reference(ZM-Core Practitioner Profile) Practitioner that provides services for the organization
... organization SΣ 1..1 Reference(ZM-Core Organization Profile) Organization where the roles are available
... code SΣ 1..* CodeableConcept Roles which this practitioner may perform
Binding: PractitionerRole (example): The role a person plays representing an organization.
... specialty SΣ 0..* CodeableConcept Specific specialty of the practitioner
Binding: PracticeSettingCodeValueSet (preferred): Specific specialty associated with the agency.
... location SΣ 1..* Reference(ZM-Core Location Profile) Location(s) where the practitioner provides care
... healthcareService S 0..* Reference(ZM-Core Healthcare Service Profile) Healthcare services provided for this role's Organization/Location(s)
... contact S 1..* ExtendedContactDetail Official contact details relating to this PractitionerRole
... communication S 0..* CodeableConcept A language the practitioner (in this role) can use in patient communication
Binding: AllLanguages (required): IETF language tag for a human language
Additional BindingsPurpose
CommonLanguages Starter

... availability S 0..* Availability Times the Practitioner is available at this location and/or healthcare service (including exceptions)
... endpoint S 0..* Reference(Endpoint) Endpoints for interacting with the practitioner in this role

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
PractitionerRole.code Base example Practitioner Role 📍5.0.0 FHIR Std.
PractitionerRole.specialty Base preferred Practice Setting Code Value Set 📍5.0.0 FHIR Std.
PractitionerRole.communication Base required All Languages 📍5.0.0 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error PractitionerRole If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error PractitionerRole If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().ofType(canonical) | %resource.descendants().ofType(uri) | %resource.descendants().ofType(url))) or descendants().where(reference = '#').exists() or descendants().where(ofType(canonical) = '#').exists() or descendants().where(ofType(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error PractitionerRole If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error PractitionerRole If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice PractitionerRole A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()

Differential View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PractitionerRole 0..* PractitionerRole Roles/organizations the practitioner is associated with
... identifier S 1..* Identifier Identifiers for a role/location
... active S 1..1 boolean Whether this practitioner role record is in active use
... period S 0..1 Period The period during which the practitioner is authorized to perform in these role(s)
... organization S 1..1 Reference(ZM-Core Organization Profile) Organization where the roles are available
... code S 1..* CodeableConcept Roles which this practitioner may perform
... specialty S 0..* CodeableConcept Specific specialty of the practitioner
... location S 1..* Reference(ZM-Core Location Profile) Location(s) where the practitioner provides care
... healthcareService S 0..* Reference(ZM-Core Healthcare Service Profile) Healthcare services provided for this role's Organization/Location(s)
... contact S 1..* ExtendedContactDetail Official contact details relating to this PractitionerRole
... communication S 0..* CodeableConcept A language the practitioner (in this role) can use in patient communication
... availability S 0..* Availability Times the Practitioner is available at this location and/or healthcare service (including exceptions)
... endpoint S 0..* Reference(Endpoint) Endpoints for interacting with the practitioner in this role

doco Documentation for this format

Snapshot ViewView

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PractitionerRole 0..* PractitionerRole Roles/organizations the practitioner is associated with
... id Σ 0..1 id Logical id of this artifact
... meta Σ 0..1 Meta Metadata about the resource
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... extension 0..* Extension Additional content defined by implementations
... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored
... identifier SΣ 1..* Identifier Identifiers for a role/location
... active SΣ 1..1 boolean Whether this practitioner role record is in active use
... period SΣ 0..1 Period The period during which the practitioner is authorized to perform in these role(s)
... practitioner SΣ 1..1 Reference(ZM-Core Practitioner Profile) Practitioner that provides services for the organization
... organization SΣ 1..1 Reference(ZM-Core Organization Profile) Organization where the roles are available
... code SΣ 1..* CodeableConcept Roles which this practitioner may perform
Binding: PractitionerRole (example): The role a person plays representing an organization.
... specialty SΣ 0..* CodeableConcept Specific specialty of the practitioner
Binding: PracticeSettingCodeValueSet (preferred): Specific specialty associated with the agency.
... location SΣ 1..* Reference(ZM-Core Location Profile) Location(s) where the practitioner provides care
... healthcareService S 0..* Reference(ZM-Core Healthcare Service Profile) Healthcare services provided for this role's Organization/Location(s)
... contact S 1..* ExtendedContactDetail Official contact details relating to this PractitionerRole
... characteristic 0..* CodeableConcept Collection of characteristics (attributes)
Binding: ServiceMode (example): A custom attribute that could be provided at a service (e.g. Wheelchair accessibility).
... communication S 0..* CodeableConcept A language the practitioner (in this role) can use in patient communication
Binding: AllLanguages (required): IETF language tag for a human language
Additional BindingsPurpose
CommonLanguages Starter

... availability S 0..* Availability Times the Practitioner is available at this location and/or healthcare service (including exceptions)
... endpoint S 0..* Reference(Endpoint) Endpoints for interacting with the practitioner in this role

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
PractitionerRole.language Base required All Languages 📍5.0.0 FHIR Std.
PractitionerRole.code Base example Practitioner Role 📍5.0.0 FHIR Std.
PractitionerRole.specialty Base preferred Practice Setting Code Value Set 📍5.0.0 FHIR Std.
PractitionerRole.characteristic Base example Service Mode 📍5.0.0 FHIR Std.
PractitionerRole.communication Base required All Languages 📍5.0.0 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error PractitionerRole If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error PractitionerRole If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().ofType(canonical) | %resource.descendants().ofType(uri) | %resource.descendants().ofType(url))) or descendants().where(reference = '#').exists() or descendants().where(ofType(canonical) = '#').exists() or descendants().where(ofType(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error PractitionerRole If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error PractitionerRole If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice PractitionerRole A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()

 

Other representations of profile: CSV, Excel, Schematron